home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / SCSL / clacon.z / clacon
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. CCCCLLLLAAAACCCCOOOONNNN((((3333SSSS))))                                                          CCCCLLLLAAAACCCCOOOONNNN((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      CLACON - estimate the 1-norm of a square, complex matrix A
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      SUBROUTINE CLACON( N, V, X, EST, KASE )
  13.  
  14.          INTEGER        KASE, N
  15.  
  16.          REAL           EST
  17.  
  18.          COMPLEX        V( N ), X( N )
  19.  
  20. IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  21.      These routines are part of the SCSL Scientific Library and can be loaded
  22.      using either the -lscs or the -lscs_mp option.  The -lscs_mp option
  23.      directs the linker to use the multi-processor version of the library.
  24.  
  25.      When linking to SCSL with -lscs or -lscs_mp, the default integer size is
  26.      4 bytes (32 bits). Another version of SCSL is available in which integers
  27.      are 8 bytes (64 bits).  This version allows the user access to larger
  28.      memory sizes and helps when porting legacy Cray codes.  It can be loaded
  29.      by using the -lscs_i8 option or the -lscs_i8_mp option. A program may use
  30.      only one of the two versions; 4-byte integer and 8-byte integer library
  31.      calls cannot be mixed.
  32.  
  33. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  34.      CLACON estimates the 1-norm of a square, complex matrix A. Reverse
  35.      communication is used for evaluating matrix-vector products.
  36.  
  37.  
  38. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  39.      N      (input) INTEGER
  40.             The order of the matrix.  N >= 1.
  41.  
  42.      V      (workspace) COMPLEX array, dimension (N)
  43.             On the final return, V = A*W,  where  EST = norm(V)/norm(W) (W is
  44.             not returned).
  45.  
  46.      X      (input/output) COMPLEX array, dimension (N)
  47.             On an intermediate return, X should be overwritten by A * X,   if
  48.             KASE=1, A' * X,  if KASE=2, where A' is the conjugate transpose of
  49.             A, and CLACON must be re-called with all the other parameters
  50.             unchanged.
  51.  
  52.      EST    (output) REAL
  53.             An estimate (a lower bound) for norm(A).
  54.  
  55.      KASE   (input/output) INTEGER
  56.             On the initial call to CLACON, KASE should be 0.  On an
  57.             intermediate return, KASE will be 1 or 2, indicating whether X
  58.             should be overwritten by A * X  or A' * X.  On the final return
  59.             from CLACON, KASE will again be 0.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCLLLLAAAACCCCOOOONNNN((((3333SSSS))))                                                          CCCCLLLLAAAACCCCOOOONNNN((((3333SSSS))))
  71.  
  72.  
  73.  
  74. FFFFUUUURRRRTTTTHHHHEEEERRRR DDDDEEEETTTTAAAAIIIILLLLSSSS
  75.      Contributed by Nick Higham, University of Manchester.
  76.      Originally named CONEST, dated March 16, 1988.
  77.  
  78.      Reference: N.J. Higham, "FORTRAN codes for estimating the one-norm of a
  79.      real or complex matrix, with applications to condition estimation", ACM
  80.      Trans. Math. Soft., vol. 14, no. 4, pp. 381-396, December 1988.
  81.  
  82.      Last modified:  April, 1999
  83.  
  84.  
  85. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  86.      INTRO_LAPACK(3S), INTRO_SCSL(3S)
  87.  
  88.      This man page is available only online.
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.